Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptEjectPage

QuickDraw GX sends the GXPostScriptEjectPage message when printing of a page is done and the printer is ready for the next page. You can override the GXPostScriptEjectPage message to perform any actions required after a page has been printed and before the next page begins. Your override of the GXPostScriptEjectPage message must match the following formal declaration:

OSErr MyPostScriptEjectPage (gxPaperType aPaperType,
               long pageIndex, long copiesCount, short erasePage,
               gxPostScriptImageDataHandle hImageData);

aPaperType

The paper-type object for the page that was just printed.

pageIndex

The page number of the page that was just printed.

copiesCount

The number of copies of the page needed.

erasePage

A value that indicates whether the printer's frame buffer needs to be erased when the page is ejected.

hImageData

A handle to the PostScript imaging system structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptEjectPage message when the imaging system has completed imaging tasks for a single page and is ready for the next page.

You can specify whether the page image is to be erased from the printer's frame buffer
in the erasePage parameter. If this value is true, the imaged is erased from the page buffer. If the difference between the page that was just printed and the next page is minimal, not erasing the frame buffer can significantly improve the printing speed. This is often used when printing forms.

The default implementation of this message uses the PostScript showpage operator when the page image needs to be erased and uses the PostScript copypage operator when the page image is not to be erased.

SPECIAL CONSIDERATIONS

You usually forward the GXPostScriptEjectPage message to allow other message handlers the opportunity to determine if the frame buffer needs to be erased.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptEjectPage message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The PostScript imaging system structure is described on page 4-26.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help